Skip to content

fix(zed): use the codegraph-mcp extension id - #206

Merged
sunerpy merged 1 commit into
mainfrom
fix/zed-extension-id-codegraph-mcp
Aug 16, 2026
Merged

sunerpy merged 1 commit into
mainfrom
fix/zed-extension-id-codegraph-mcp

Conversation

@sunerpy

@sunerpy sunerpy commented Aug 16, 2026

Copy link
Copy Markdown
Owner

Follow-up to #203, which shipped the id as mcp-server-codegraph. Changing it to codegraph-mcp before the registry entry goes live — an extension id cannot be changed after publication, so it is worth settling now.

Why the suffix form

The binding rule is that the id must convey what the extension does, and the docs phrase it as a suffix:

for themes, it should be suffixed with -theme, snippet extensions should be suffixed with -snippets and so on

-mcp satisfies that while keeping the product name first. The registry already hosts 14 *-mcp entries — azure-mcp, sentry-mcp, prisma-mcp, svelte-mcp, chrome-devtools-mcp among them, several being binary-downloading context servers exactly like this one. codegraph-mcp is unoccupied.

The previous mcp-server-codegraph was chosen off a raw count (44 mcp-server-* prefix entries vs 0 *-mcp-server), which overweighted precedent: the maintainer's own instruction on a sibling PR permits mcp-server as prefix or suffix, so "zero precedent for that exact string" was never a compliance problem, and the docs' own wording leans suffix.

What moved, and what deliberately did not

The registry submodule directory and extensions.toml table key must equal the id, so the publishing instructions move with it.

[context_servers.codegraph] stays. It is independent of the extension id — the published chrome-devtools-mcp declares [context_servers.chrome-devtools-mcp-zed] — and it is the key that codegraph install / codegraph init --target=zed writes into Zed's settings.json. Renaming it would break every existing config for no gain. SERVER_ID and src/lib.rs are untouched.

Version goes to 0.2.1, since 0.2.0 already shipped under the old id.

Also corrected

A discoverability claim I had added in #203 said the extension store searches the name field. Only the dev-extension path is verifiable from Zed's source (crates/extensions_ui/src/extensions_ui.rs:560 builds candidates from manifest.name); the store path is a server-side fetch_extensions query whose matched fields aren't visible from the client. The sentence now claims only what extensions_ui.rs:802 shows — that name is the displayed headline.

Verification

  • grep for the old id returns zero hits; no context_servers.codegraph-mcp anywhere; src/lib.rs, crates/, and the root Cargo.toml/Cargo.lock show an empty diff.
  • Built against wasm32-wasip2 and clippy --all-targets -- -D warnings clean, both from inside editors/zed/ (own workspace root).
  • make ci green at 127 suites / 3156 passed / 0 failed, matching main.

The registry rule is that an id must convey what the extension does, and the
docs phrase it as a suffix ("themes should be suffixed with -theme, snippets
with -snippets"). `-mcp` is the shortest form that satisfies it while keeping
the product name first, and the registry already hosts 14 such entries
including azure-mcp, sentry-mcp, prisma-mcp and chrome-devtools-mcp — several
of them binary-downloading context servers like this one. `codegraph-mcp` is
unoccupied.

The registry submodule directory and extensions.toml table key must equal the
id, so the publishing docs move with it. `[context_servers.codegraph]` does
not: it is independent of the id (the published chrome-devtools-mcp declares a
different one) and it is the key `codegraph install` writes into Zed's
settings.json, so renaming it would break existing configs.

Also drops a claim about what the extension store searches. Only the
dev-extension path is verifiable from Zed's source, where `name` is the
displayed headline; the store query is server-side.
@codecov

codecov Bot commented Aug 16, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

Impacted file tree graph

@@           Coverage Diff           @@
##             main     #206   +/-   ##
=======================================
  Coverage   95.18%   95.18%           
=======================================
  Files         136      136           
  Lines       73024    73024           
=======================================
+ Hits        69510    69511    +1     
+ Misses       3514     3513    -1     

see 1 file with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@sunerpy
sunerpy merged commit 49a9635 into main Aug 16, 2026
7 checks passed
@sunerpy
sunerpy deleted the fix/zed-extension-id-codegraph-mcp branch August 16, 2026 14:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant